---
template: splash
title: Bloc State Management Library
description:
  Official documentation for the bloc state management library. Support for
  Dart, Flutter, and AngularDart. Includes examples and tutorials.
banner:
  content: |
    ✨ Visit the
    <a href="https://shop.bloclibrary.dev">Bloc Shop</a> ✨
editUrl: false
lastUpdated: false
hero:
  title: Bloc <sup><span style="font-size:0.4em">v9.1.0</span></sup>
  tagline: A predictable state management library for Dart.
  image:
    alt: Bloc logo
    file: ~/assets/bloc.svg
  actions:
    - text: Get Started
      link: /getting-started/
      variant: primary
      icon: rocket
    - text: View on GitHub
      link: https://github.com/felangel/bloc
      icon: github
      variant: secondary
---

import { CardGrid } from '@astrojs/starlight/components';
import SponsorsGrid from '~/components/landing/SponsorsGrid.astro';
import Card from '~/components/landing/Card.astro';
import ListCard from '~/components/landing/ListCard.astro';
import SplitCard from '~/components/landing/SplitCard.astro';
import Discord from '~/components/landing/Discord.astro';

<SponsorsGrid />

<hr />

<CardGrid>

<SplitCard title="Get Started" icon="rocket">
	```sh
	# Add bloc to your project.
	dart pub add bloc
	```

Our [getting started guide](/getting-started) has step-by-step instructions on
how to start using Bloc in just a few minutes.

</SplitCard>

<Card title="Take a guided tour" icon="star">
	Complete [the official tutorials](/tutorials/flutter-counter) to learn best
	practices and build a variety of different apps powered by Bloc.
</Card>

<Card title="Build with Bloc" icon="laptop">
	Explore high quality, fully tested [sample
	apps](https://github.com/felangel/bloc/tree/master/examples) like the counter,
	timer, infinite list, weather, todo and more!
</Card>

<ListCard title="Learn" icon="open-book">

    - [Why Bloc?](/why-bloc)
    - [Core Concepts](/bloc-concepts)
    - [Architecture](/architecture)
    - [Testing](/testing)
    - [Naming Conventions](/naming-conventions)
    - [FAQs](/faqs)

</ListCard>

  <ListCard title="Integrations" icon="puzzle">
    - [VSCode Integration](https://marketplace.visualstudio.com/items?itemName=FelixAngelov.bloc)
    - [IntelliJ Integration](https://plugins.jetbrains.com/plugin/12129-bloc)
    - [Neovim Integration](https://github.com/wa11breaker/flutter-bloc.nvim)
    - [Mason CLI Integration](https://github.com/felangel/bloc/blob/master/bricks/README.md)
    - [Custom Templates](https://brickhub.dev/search?q=bloc)
    - [Developer Tools](https://github.com/felangel/bloc/blob/master/packages/bloc_tools/README.md)
  </ListCard>
</CardGrid>

<Discord />
